     * 
     */
    /**
 * 
 */
/**
} 
     * 查询退款状态
     * 查询支付状态
     * 处理退款
     * 处理支付回调
     * 创建支付订单
     * 从第三方平台同步支付状态
    // ========================= 对账管理 =========================
     * 对账结果处理
     * 发送支付提醒
     * 发送支付通知
     * 分页查询支付订单
     * 根据订单号获取支付订单
     * 更新用户支付限额
     * 更新支付订单状态
    // ========================= 缓存管理 =========================
     * 获取可用支付渠道
     * 获取用户退款记录
     * 获取用户支付订单列表
     * 获取用户支付行为分析
     * 获取用户支付限额
     * 获取支付订单详情
     * 获取支付趋势分析
     * 获取支付渠道分析
     * 获取支付渠道列表
     * 获取支付渠道配置
     * 获取支付统计信息
     * 检查支付渠道可用性
     * 检查支付限额
     * 批量查询支付状态
     * 批量发送支付超时提醒
     * 清除用户支付缓存
     * 清除支付渠道缓存
     * 清除支付相关缓存
     * 申请退款
     * 生成对账单
    // ========================= 通知管理 =========================
     * 同步支付状态
    // ========================= 统计分析 =========================
 * 统一支付处理，从物业管理模块拆分而来
     * 统一支付接口
    // ========================= 退款管理 =========================
     * 微信支付
     * 微信支付回调
     * 下载对账单
     * 验证回调签名
     * 银行卡支付
     * 银行卡支付回调
     * 用于生成支付二维码或预支付信息
     * 余额支付
     * 预创建支付订单
    // ========================= 支付安全 =========================
     * 支付宝支付
     * 支付宝支付回调
    // ========================= 支付查询 =========================
    // ========================= 支付处理 =========================
    // ========================= 支付订单管理 =========================
     * 支付风险检测
 * 支付服务接口
    // ========================= 支付回调处理 =========================
    // ========================= 支付渠道管理 =========================
    // ========================= 支付限额管理 =========================
     * 支付验证码发送
     * 支付验证码验证
     * 执行退款
 * @author Wu.Liang
    boolean balancePay(String orderNo, String paymentPassword);
    boolean checkPaymentChannelAvailability(String paymentChannel);
    boolean executeRefund(Long refundId);
    boolean processRefund(Long refundId, String approvalResult, String approvalRemark);
    boolean sendPaymentNotification(String orderNo, String notifyType, String notifyChannel);
    boolean sendPaymentReminder(String orderNo);
    boolean sendPaymentVerifyCode(Long userId, String orderNo, String verifyType);
    boolean syncPaymentStatus(String orderNo);
    boolean updatePaymentOrderStatus(Long orderId, Integer status, String remark);
    boolean updateUserPaymentLimit(Long userId, String paymentChannel, BigDecimal dailyLimit, BigDecimal monthlyLimit);
    boolean verifyCallbackSignature(String paymentChannel, Map<String, String> notifyData);
    boolean verifyPaymentCode(Long userId, String orderNo, String verifyCode);
import com.smart.community.commons.base.IBaseService;
import com.smart.community.commons.result.PageResult;
import com.smart.community.payment.dto.PaymentCallbackDTO;
import com.smart.community.payment.dto.PaymentDTO;
import com.smart.community.payment.dto.RefundDTO;
import com.smart.community.payment.entity.PaymentOrder;
import com.smart.community.payment.vo.PaymentOrderVO;
import com.smart.community.payment.vo.PaymentStatisticsVO;
import java.math.BigDecimal;
import java.util.List;
import java.util.Map;
    List<Map<String, Object>> batchQueryPaymentStatus(List<String> orderNos);
    List<Map<String, Object>> getAvailablePaymentChannels(BigDecimal amount, String clientType);
    List<Map<String, Object>> getPaymentChannels(String clientType);
    List<Map<String, Object>> getPaymentTrend(Long communityId, String period);
    List<Map<String, Object>> getUserRefundRecords(Long userId);
    List<PaymentOrderVO> getUserPaymentOrders(Long userId);
    Long applyRefund(RefundDTO refundDTO);
    Long createPaymentOrder(PaymentDTO paymentDTO);
    Long generateReconciliationBill(String paymentChannel, String billDate);
    Map<String, Integer> batchSendPaymentTimeoutReminder(Long communityId);
    Map<String, Object> alipayPay(String orderNo, String clientType);
    Map<String, Object> bankCardPay(String orderNo, Map<String, Object> bankCardInfo);
    Map<String, Object> checkPaymentLimit(Long userId, BigDecimal amount, String paymentChannel);
    Map<String, Object> createPrePaymentOrder(PaymentDTO paymentDTO);
    Map<String, Object> detectPaymentRisk(Long userId, String orderNo, String paymentChannel);
    Map<String, Object> getPaymentChannelAnalysis(Long communityId, String timeRange);
    Map<String, Object> getPaymentChannelConfig(String paymentChannel);
    Map<String, Object> getUserPaymentBehavior(Long userId, String timeRange);
    Map<String, Object> getUserPaymentLimit(Long userId, String paymentChannel);
    Map<String, Object> processReconciliationResult(Long billId);
    Map<String, Object> queryPaymentStatus(String orderNo);
    Map<String, Object> queryRefundStatus(Long refundId);
    Map<String, Object> unifiedPay(String orderNo, String paymentChannel, String clientType);
    Map<String, Object> wechatPay(String orderNo, String clientType);
package com.smart.community.payment.service;
    PageResult<PaymentOrderVO> pagePaymentOrders(PaymentDTO paymentDTO);
     * @param amount 支付金额
     * @param approvalRemark 审批备注
     * @param approvalResult 审批结果：approved-通过，rejected-拒绝
     * @param bankCardInfo 银行卡信息
     * @param billDate 对账日期
     * @param billId 对账单ID
     * @param callbackDTO 回调数据
     * @param clientType 客户端类型
     * @param clientType 客户端类型：web-网页，app-APP，h5-H5
     * @param communityId 社区ID
     * @param dailyLimit 日限额
     * @param endDate 结束日期
     * @param monthlyLimit 月限额
     * @param notifyChannel 通知渠道：sms-短信，email-邮件，app-APP推送
     * @param notifyData 回调数据
     * @param notifyData 微信回调数据
     * @param notifyData 银行回调数据
     * @param notifyData 支付宝回调数据
     * @param notifyType 通知类型：success-成功，failed-失败，timeout-超时
     * @param orderId 订单ID
     * @param orderNo 订单号
     * @param orderNos 订单号列表
     * @param paymentChannel 支付渠道
     * @param paymentChannel 支付渠道：wechat-微信，alipay-支付宝，bank-银行卡
     * @param paymentDTO 查询条件
     * @param paymentDTO 支付信息
     * @param paymentPassword 支付密码
     * @param period 统计周期：day-日，week-周，month-月
     * @param refundDTO 退款信息
     * @param refundId 退款ID
     * @param remark 备注
     * @param startDate 开始日期
     * @param status 订单状态
     * @param timeRange 时间范围
     * @param userId 用户ID
     * @param verifyCode 验证码
     * @param verifyType 验证类型：sms-短信，email-邮件
    PaymentOrderVO getPaymentOrderByOrderNo(String orderNo);
    PaymentOrderVO getPaymentOrderDetail(Long orderId);
    PaymentStatisticsVO getPaymentStatistics(Long communityId, String startDate, String endDate);
public interface IPaymentService extends IBaseService<PaymentOrder> {
     * @return 处理结果
     * @return 订单列表
     * @return 订单详情
     * @return 订单ID
     * @return 对账单文件路径
     * @return 对账单ID
     * @return 对账结果
     * @return 发送结果统计
     * @return 分页结果
     * @return 风险检测结果
     * @return 行为分析数据
     * @return 可用渠道列表
     * @return 趋势数据
     * @return 渠道分析数据
     * @return 渠道列表
     * @return 渠道配置
     * @return 是否处理成功
     * @return 是否发送成功
     * @return 是否更新成功
     * @return 是否可用
     * @return 是否同步成功
     * @return 是否退款成功
     * @return 是否验证通过
     * @return 是否支付成功
     * @return 统计信息
     * @return 退款记录列表
     * @return 退款状态信息
     * @return 退款ID
     * @return 微信支付信息
     * @return 限额检查结果
     * @return 银行卡支付信息
     * @return 预支付信息
     * @return 支付宝支付信息
     * @return 支付限额信息
     * @return 支付信息
     * @return 支付状态信息
     * @return 支付状态信息列表
 * @since 2025-06-26
    String downloadReconciliationBill(Long billId);
    String handleAlipayCallback(Map<String, String> notifyData);
    String handleBankCallback(Map<String, String> notifyData);
    String handlePaymentCallback(PaymentCallbackDTO callbackDTO);
    String handleWechatCallback(String notifyData);
 * @version 1.0.0
    void clearPaymentCache(String orderNo);
    void clearPaymentChannelCache(String paymentChannel);
    void clearUserPaymentCache(Long userId);
